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EFFICIENT USE OF DOMAIN SOCKET PAIRS IN COMMUNICATION 
FOR TIGHTLY COUPLED TRANSACTIONS 



BACKGROUND OF THE INVENTION 
FIELD OF THE INVENTION 

The present invention is directed to an improvement in computing systems and in particular to 
computing systems which provide for the efficient use of domain socket pairs in communication for 
tightly coupled transactions. 

DESCRIPTION OF THE RELATED ART 

In the processing of transactional data, it is common to have a DBMS (database management system) 
which stores data for retrieval and updating by transactions which are processed by one or more 
distinct branches of an application. In such systems it is known to include gateways which provide 
for connections between the application system or systems and a server system which hosts the 
DBMS. Software has been developed based on the X Open standard XA for handling transactions 
in such an environment. Commercial systems such as CICS™ and BEA Tuxedo™ provide 
transaction control for an application, based on the XA model. (CICS is a trademark of the IBM 
Corporation; BEA Tuxedo is a trademark of BEA Systems, Inc.) XA permits several different 
connections to be established between an application, a gateway and the server hosting the DBMS. 

However, certain DBMSs do not directly support XA. Such a system typically employs a rigid 
connection pattern to prevent connections being made in a way which will permit execution of 
transaction operations in the DBMS which are unintended by the applications using the DBMS. 

It is therefore desirable to have a computer system for the connection of applications to a server 
hosting a non-XA supporting DBMS by way of a gateway which supports the XA standard while 
providing flexibility in the connectivity between the application and the gateway. 
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SUMMARY OF THE INVENTION 

According to one aspect of the present invention, there is provided an improved system for the 
efficient use of domain socket pairs in communication for tightly coupled transactions. 

According to another aspect of the present invention, there is provided a computer system for 
providing a gateway between a transaction manager for managing database transactions from a set 
of applications, and a server, the computer system including a listener process for receiving inbound 
connection requests from the transaction manager, a set of gateway agents for establishing 
connections to the transaction manager for receiving transaction requests and for establishing 
connections to the server, a wait queue, a logical agent scheduler for managing sets of logical agents, 
a logical agent comprising data representing a connected application from the transaction manager, 
each logical agent having an associated inbound connection identifier, whereby the logical agent 
scheduler passes a selected logical agent and an associated inbound connection identifier to an 
available gateway agent and where the gateway has no available gateway agent, providing the logical 
agent and the associated inbound connection identifier to the wait queue, a selected gateway agent 
removes a logical agent and an associated inbound connection identifier from the wait queue when 
the selected gateway agent is available and the wait queue is non-empty, and for a logical agent 
passed by the logical agent scheduler or removed from the wait queue, the gateway agent establishes 
a connection to the transaction manager as defined by the associated inbound connection identifier 
and establishing a connection to the server to implement the logical agent. 

According to another aspect of the present invention, there is provided the above computer system 
in which the gateway implements tightly coupled XA transactions from the set of applications by 
dedicating a single gateway agent to any given tightly coupled XA transaction, the listener process, 
the logical agent scheduler and the gateway agents passing logical agents to gateway agents such that 
any logical agent representing a transaction in that given tightly coupled XA transaction will be 
executed by a given gateway agent dedicated to that given tightly coupled XA transaction. 

According to another aspect of the present invention, there is provided the above computer system 



CA9- 1999-0046 



2 



having a free agent list indicating which gateway agents are available for connection to the 
transaction manager and which are not dedicated to any given tightly coupled XA transaction. 

According to another aspect of the present invention, there is provided the above computer system 
which is implemented in a UNIX™-based environment in which the connections to the transaction 
manager are TCP/IP socket pairs and in which the passing of logical agents and associated inbound 
connection endpoint identifiers is implemented by the use of domain socket pairs in the gateway. 
(UNIX is a registered trademark of the Open Group.) 

According to another aspect of the present invention, there is provided the above computer system 
in which the wait queue is implemented as a domain socket pair in the gateway. 

According to another aspect of the present invention, there is provided the above computer system 
in which domain sockets are assigned such that the logical agent scheduler has a domain socket pair 
dedicated for receiving logical agent and associated inbound connection pairs from the gateway 
agents and the listener process, and the domain socket pairs for other communication in the gateway 
are obtained from a pool of domain sockets, whereby in the case that no domain socket pair is 
available in the domain socket pool for transfer of a logical agent and associated inbound connection 
pair the logical agent scheduler will place the logical agent and associated inbound connection pair 
in the domain socket pair which implements the wait queue. 

According to another aspect of the present invention, there is a gateway for demultiplexing 
connections from a first system to a second system, the gateway comprising internal processes which 
are selectively connected to implement the demultiplexing function of the gateway, the gateway 
including a wait queue, the wait queue providing a buffering function for both the connections 
between the first system and the second system and for the connections between the internal 
processes. 

According to another aspect of the present invention, there is provided the above gateway in which 
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the connections between the first system and the second system are TCP/IP socket pairs and the 
connections between the internal processes are domain socket pairs, and in which the wait queue is 
implemented by a domain socket pair. 

According to another aspect of the present invention, there is provided a computer system for 
demultiplexing a set of TCP/IP inbound connections to a set of Outbound connections, the computer 
system including a plurality of scheduler processes for providing TCP/IP inbound connections to 
agent processes for establishing corresponding Outbound connections, the scheduler processes and 
the agent processes communicating by domain socket pairs in the computer system, each scheduler 
process having a dedicated domain socket pair for receiving a TCP/IP inbound connection endpoint, 
the domain socket pairs for communication to the agent processes being available from a pool of 
domain sockets. 

According to another aspect of the present invention, there is provided the above computer system 
including a wait queue implemented as a domain socket pair, the wait queue receiving a TCP/IP 
inbound connection endpoint where no agent process is available for implementing the TCP/IP 
inbound connection and from which non-empty wait queue an available agent process will remove 
a TCP/IP inbound connection endpoint to establish a TCP/IP inbound connection and an outbound 
connection. 

According to another aspect of the present invention, there is provided a computer program product 
for use with a computer including a central processing unit and random access memory, said 
computer program product including a computer usable medium having computer readable code 
means embodied in the medium providing a gateway as described above. 

Advantages of the present invention include a gateway which supports an agent affinity for all 
connections for transactions participating in a global transaction. Server resources are reduced for 
each application by demultiplexing inbound connections to a smaller number of connections to the 
DBMS server. Multiple applications are able to be demultiplexed to a single outbound connection 
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on well defined boundaries. 



BRIEF DESCRIPTION OF THE DRAWINGS 

The preferred embodiment of the invention is shown in the drawings, wherein: 

Figure 1 is a block diagram illustrating an example transaction manager and a server 

connected by a gateway according to the preferred embodiment of the invention; and 

Figure 2 is a block diagram illustrating components in the gateway of the preferred 

embodiment. 

In the drawings, the preferred embodiment of the invention is illustrated by way of example. It is 
to be expressly understood that the description and drawings are only for the purpose of illustration 
and as an aid to understanding, and are not intended as a definition of the limits of the invention. 

DESCRIPTION OF THE PREFERRED EMBODIMENT 

Figure 1 is a block diagram illustrating an example transaction manager 10, gateway 12, and server 
14. Server 14 hosts a DBMS which does not directly support the XA protocol. Gateway 12 has 
multiple agents represented in the example of Figure 1 as gateway agent_l, gateway agentJ2, . . . 
gateway agent_n. The gateway agents in the example of Figure 1 are Unix processes which establish 
connections between transaction manager 10 and server 14, using TCP/IP sockets. It will be 
appreciated by those skilled in the art that other types of connection to server 14 are also possible. 
As is shown in Figure 1, transaction manager 10 has many potential connections to gateway 12, 
which are selectively connected to server 14. In Figure 1, the three gateway agents illustrated are 
shown connected, while other inbound connections to gateway 1 2 (from transaction manager 1 0) are 
not shown connected to server 14. In this way, Figure 1 shows gateway 12 acting as a demultiplexer 
(or concentrator) for connections from transaction manager 10. 

Figure 2 is a block diagram illustrating a extremely simple example of the architecture of gateway 
12. Gateway 12 in the example of the preferred embodiment is implemented in UNIX in a TCP/IP 
environment. Those skilled in the art will appreciate that the preferred embodiment may be 
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implement in other environments with similar process and socket management structures. As shown 
in Figure 1, gateway 12 manages inbound TCP/IP sockets between transaction manager 10 and 
gateway 12. In Figure 2, gateway agent 20 and gateway agent 22 are shown with inbound socket 
connections represented by horizontal arrows. Similarly, gateway agents 20, 22 are shown with 
outbound socket connections (to server 14) represented by vertical arrows. 

Gateway 1 2 in the preferred embodiment manages the connections between transaction manager 1 0 
and server 14 by creating logical agents. A logical agent in the preferred embodiment is an entity 
which represents a connected application (a connection from transaction manager 10) and has 
associated data representing information and control blocks required by the application. A logical 
agent scheduler is shown in Figure 2 as LAS 24. LAS 24 manages the relationship between logical 
agents and gateway agents (represented as gateway agents 20, 22 in Figure 2). Gateway agents 20, 
22 execute application requests, but have no permanent attachment to any particular application. The 
gateway agent owns all the information and control blocks required to implement a connection to 
the server for an inbound application. By dividing up agents into logical agents and gateway agents, 
the system of the preferred embodiment is able to achieve a demultiplexing, or concentrating, 
function as is set out below. 

Referring to Figure 2, TCP/IP listener 26 is shown. TCP/IP listener 26 listens for requests for a 
connection made by transaction manager 1 0. When TCP/IP listener 26 receives such a connection 
request, it generates a logical agent and records the associated TCP/IP inbound connection 
endpoint . The logical agent and the TCP/IP inbound connection endpoint are passed by the TCP/IP 
listener to other processes illustrated in Figure 2 according to the availability of resources. 

In UNIX platforms, TCP/IP socket endpoints may be passed between processes using domain socket 
pairs. Figure 2 shows example connections for the transfer of such messages in gateway 12. Each 
message is sent through a connected domain socket pair. Each message contains two parts, a control 
part and a data part. The control part contains the inbound TCP/IP connection end-point, and the data 
part contains the address of the logical agent control block. This guarantees that the TCP/IP 
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connection end-point and the logical agent that owns it always stay together during the transfer. 

In the system of the preferred embodiment, gateway 1 2 supports XA compliant transactions and will 
generate connections to a server hosting a DBMS which does not support XA verbs. For example, 
a server with a 390 or 400 variation of DB2 UDB™ will not process XA verb statements when 
connecting to those servers via the X Open DRDA protocol. (DB2 and DB2 Universal Database are 
trademarks of the IBM Corporation.) However, gateway 12 imposes a single and exclusive gateway 
agent connection for all requests participating in the same tightly coupled XA transaction. In this 
way, all tightly coupled statements, that is all statements sharing the same transfer identifier (XID) 
under the XA protocol, will use the same connection to the server, even if such SQL requests are 
received from different applications. This will ensure that agent level affinity is achieved for the 
system, despite the backend DBMS system not supporting the XA protocol. 

The logic which provides this connectivity functionality is found in the processes shown in Figure 
2. Gateway agents (20, 22 in the example of Figure 2) are potentially associated with specific global 
transactions. When a new connection request from transaction manager 10 is received by TCP/IP 
listener 26, free agent list 28 is checked. If a gateway agent is on free agent list 28 then it is not 
associated with an ongoing global transaction. In this case, the logical agent and inbound connection 
identifier for the new connection are passed to the free gateway agent to create the inbound 
connection to the transaction manager. The gateway agent is removed from the free agent list. 

In the example of Figure 2, the connection between TCP/IP listener 26 and gateway agent 20 
represents such a transfer of logical agent and inbound connection from TCP/IP listener 26 to 
gateway agent 20. Once the connection request is passed to gateway agent 20, then the gateway 
agent establishes a connection to transaction manager 10 and receives requests from transaction 
manager 10. If gateway agent 20 receives an XA request starting a global transaction (XA REG 
START) the result is a unique XID being assigned to the global transaction. The system of the 
preferred embodiment will then reserve that gateway agent for transactions associated with the 
unique XID, only. Gateway agent 20 will if necessary establish a connection (or reuse an existing 
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connection) to server 14 and all transactions with the unique XID will be communicated to server 
14 with the same connection. This results in the agent affinity aspect of the tightly coupled XA 
transaction model being implemented without the server 14 DBMS having direct support for that 
protocol. 

Other connections from transaction manager 10 to gateway 12 may be used to sent transaction 
requests which are part of the global transaction being handled by gateway 20. In this case, those 
logical agents corresponding to such requests are sent to gateway agent 20, as described below. 
Gateway agent 20 will establish inbound socket connections to transaction manager 10 to permit 
those transactions to be sent to server 14 from gateway 20. Gateway 20 may also receive requests 
from transaction manager 10 which do not relate to the global transaction which gateway 20 is 
dedicated to handling. In this case, the request (as defined by the logical agent and inbound socket 
information) is sent to the appropriate gateway agent, as described below. 

LAS 24 manages the scheduling of logical agents in the gateway. LAS 24 will determine what XID, 
if any, is associated with a particular logical agent. The logical agent scheduler LAS 24 will 
determine whether a gateway agent is dedicated to the XID for the logical agent. If there is a 
gateway agent which is dedicated to the XID and which is available, the logical agent is sent to that 
gateway agent. If there is no gateway agent available to handle the particular logical agent, the 
logical agent and the associated inbound connection socket identifier are placed in wait queue 30. 

Due to the restriction of the number of open file handles that exists for certain platforms (for 
example, a maximum of 2000 on AIX™) it may be necessary to have more than one logical agent 
scheduler when the number of logical agents exceeds the file handle limit. (AIX is a trademark of 
the IBM Corporation.) This is because in protocols such as TCP/IP, sockets are file handles and one 
file handle is required in the logical agent scheduler per logical agent. Although the preferred 
embodiment is shown with reference to only a single logical agent scheduler, and only two gateway 
agents, it will be understood by those skilled in the art that the gateway of the invention may be 
scaled up to include many gateway agents for a logical agent scheduler, and many logical agent 
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schedulers. 



As is indicated by the connections shown in Figure 2, agents in the preferred embodiment may also 
pass logical agents and inbound connection identifiers between each other. This is shown in the 
5 figure by the connection between gateway agent 20 and gateway agent 22. Where an inbound 
connection established by a gateway agent results in the passing of a transaction request for a global 
transaction unrelated to the gateway agent receiveing the request, the gateway agent will not pass the 
request on to the server. In such a case, the logical agent corresponding to the transaction request 
is sent to the appropriate gateway agent. 

10 

When a global transaction branch is completed, for example by receipt of the XA END by the 
gateway agent, the logical agent associated with that global transaction is passed back to LAS 24 to 
£ permit LAS 24 to recognize that the gateway agent is available for other requests in the global 
M: transaction. LAS 24 will look into a request received from transaction manager 1 0 to determine if 
15 m a given transaction request is part of any defined global transaction, and if so, to pass the logical 
agent corresponding to the transaction request to the appropriate gateway agent (associated with the 
« global transaction), if available, or wait queue 30, if not. 

[1 When a global transaction is committed or rolled back, the global transaction is completed and an 
20"2 identifier for the gateway agent is placed in free agent list 28. 

As is indicated above, the architecture of gateway 12 permits many connections from transaction 
manager 10 to be demultiplexed to fewer connections to server 14, by gateway 12. In addition, 
gateway 12, by dedicating gateway agents to a single global transaction, permits the tightly coupled 
25 transaction of an XA protocol to be effectively implemented by gateway 12 and server 14 despite 
the lack of direct XA support in the DBMS hosted by server 14. 

In the system of the preferred embodiment each of gateway agents 20, 22, TCP/IP listener 26, LAS 
24, and free agent list 28 are implemented as processes in the UNIX environment. 
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The system of the preferred embodiment uses a particular arrangement of domain socket pairs to 
efficiently implement gateway 12 to make efficient use of system resources while providing a 
demultiplexing or concentrating function for the connection between transaction manager 10 and 
server 1 4. The system of the preferred embodiment uses a domain socket pool, in conjunction with 
assigned domain socket pairs, to provide an efficient mechanism for communication of local agent 
information in gateway 12. 

A heavy loaded system may have dozens of LASs, and hundreds of gateway agents. In such a 
system, maintaining an large pool of domain socket pairs to handle connections between different 
processes may be onerous in terms of system resources. However, a too small pool of domain 
socket pairs with an inefficient usage algorithm may cause the transfer of logical agent information 
to be a performance bottleneck in the system. 

Each logical agent scheduler (LAS) in the gateway has a dedicated domain socket pair. This domain 
socket pair acts as a single reader, multiple sender, queue. When the TCP/IP listener or a gateway 
agent seeks to transfer a logical agent to a logical agent scheduler, it sends a message through the 
send socket of the dedicated domain socket pair for that LAS. The logical agent scheduler will read 
from the receive socket of the domain socket pair to receive the logical agent and its TCP/IP 
connection end-point. 

Communication to a gateway agent is performed using a domain socket pair from the pool of domain 
socket pairs. When a TCP/IP listener, or a gateway agent, tries to hand a logical agent to a gateway 
agent, it will request a domain socket pair from the free pool. The steps of acquiring and releasing 
domain socket pairs are protected by the pool latch. 

If the process is able to find a free domain socket pair, it will send the logical agent along with the 
TCP/IP connection end-point through the domain socket pair to the appropriate gateway agent. 
When the target gateway agent receives the logical agent and the TCP/IP connection end-point, it 
will mark the domain socket pair to be free. 
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If the process cannot be provided with a free domain socket pair from the pool, the TCP/IP listener 
or the gateway agent that is requiring the transfer will wait on a waitpost area. The next process to 
free up a domain socket pair will post it and the waiting process will be able to make use of the 
domain socket pair. 

When a logical agent scheduler seeks to transfer a logical agent to a gateway agent, it will also 
request a domain socket pair from the pool, as a TCP/IP listener or a gateway agent does. However, 
if the LAS cannot find a free domain socket pair in the domain socket pool, it will send the logical 
agent and its TCP/IP connection end-point to a wait queue (shown in Figure 2 as wait queue 30). 
The wait queue is implemented by a dedicated domain socket pair. This domain socket pair acts as 
a multiple reader multiple sender queue. When a gateway agent finishes serving a transaction, it will 
read from this domain socket pair to get another logical agent to serve. In this way, wait queue 30 
provides a function of buffering logical agents where there are no domain sockets in the pool 
available for LAS to gateway agent communication. 

As will be apparent to those skilled in the art, the size of the domain socket pool for a given system 
will depend on the resources available and the expected utilization of those resources. 

There is a similar buffering function carried out if there are fewer gateway agents available than 
required at a particular time. If a logical agent scheduler detects an incoming request from one of 
the applications, but there is no available gateway agent to serve the request (because there are more 
logical agents then gateway agents), it will also send the new logical agent to the dedicated domain 
socket pair forming the wait queue. A gateway agent will then remove the logical agent from the 
wait queue once the gateway agent is available. In this way, wait queue 30, as implemented in the 
preferred embodiment of the invention, provides a queue for both gateway agent resources and 
domain socket resources. 

By assigning different domain socket pairs in this manner, an efficient use of the system resources 
at gateway 12 is achieved, while permitting a demultiplexing of requests from transaction manager 
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10 and permitting connections to server 14. 

Although a preferred embodiment of the present invention has been described here in detail, it will 
be appreciated by those skilled in the art, that variations may be made thereto, without departing 
from the spirit of the invention or the scope of the appended claims. 

The embodiments of the invention in which an exclusive property or privilege is claimed are defined 
as follows: 
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CLAIMS 



1 1 . A computer system for providing a gateway between a transaction manager for managing 

2 database transactions from a set of applications, and a server, the computer system comprising 

3 a listener process for receiving inbound connection requests from the transaction manager, 

4 a set of gateway agents for establishing connections to the transaction manager for receiving 

5 transaction requests and for establishing connections to the server, 

6 a wait queue, 

7 a logical agent scheduler for managing sets of logical agents, a logical agent comprising data 

8 representing a connected application from the transaction manager, each logical agent having an 

9 associated inbound connection identifier, 

1 CU% whereby the logical agent scheduler passes a selected logical agent and an associated inbound 

toot 

1 ljj connection identifier to an available gateway agent and where the gateway has no available gateway 

1 2j*fe agent, providing the logical agent and the associated inbound connection identifier to the wait queue, 

13ff. a selected gateway agent removes a logical agent and an associated inbound connection 

14?*! identifier from the wait queue when the selected gateway agent is available and the wait queue is 

15- non-empty, and 

1 6 for a logical agent passed by the logical agent scheduler or removed from the wait queue, the 

17[1 gateway agent establishes a connection to the transaction manager as defined by the associated 

180 inbound connection identifier and establishes a connection to the server to implement the logical 

19 agent. 

1 2. The computer system of claim 1 in which the gateway implements tightly coupled XA 

2 transactions from the set of applications by dedicating a single gateway agent to any given tightly 

3 coupled XA transaction, the listener process, the logical agent scheduler and the gateway agents 

4 passing logical agents to gateway agents such that any logical agent representing a transaction in that 

5 given tightly coupled XA transaction will be executed by a given gateway agent dedicated to that 

6 given tightly coupled XA transaction. 
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1 3. The computer system of claim 2, further comprising a free agent list indicating which 

2 gateway agents are available for connection to the transaction manager and which are not dedicated 

3 to any given tightly coupled XA transaction. 

1 4. The computer system of claim 2 implemented in a UNIX-based environment in which the 

2 connections to the transaction manager are TCP/IP socket pairs and in which the passing of logical 

3 agents and associated inbound connection endpoint identifiers is implemented by the use of domain 

4 socket pairs in the gateway. 

1 5 . The computer system of claim 4 in which the wait queue is implemented as a domain socket 

2 pair in the gateway. 

ljf 6. The computer system of claim 5 in which domain sockets are assigned such that the logical 

2M< agent scheduler has a domain socket pair dedicated for receiving logical agent and associated 

3[f s inbound connection pairs from the gateway agents and the listener process, and the domain socket 

4rt pairs for other communication in the gateway are obtained from a pool of domain sockets, 

5 s whereby in the case that no domain socket pair is available in the domain socket pool for 

foj transfer of a logical agent and associated inbound connection pair the logical agent scheduler will 

\- place the logical agent and associated inbound connection pair in the domain socket pair which 

8P implements the wait queue. 

1 7. A gateway for demultiplexing connections from a first system to a second system, the 

2 gateway comprising internal processes which are selectively connected to implement the 

3 demultiplexing function of the gateway, the gateway comprising a wait queue, the wait queue 

4 providing a buffering function for both the connections between the first system and the second 

5 system and for the connections between the internal processes. 
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1 8. The gateway of claim 7 in which the connections between the first system and the second 

2 system are TCP/IP socket pairs and the connections between the internal processes are domain 

3 socket pairs. 

1 9. The gateway of claim 8 in which the wait queue is implemented by a domain socket pair. 

1 10. A computer system for demultiplexing a set of TCP/IP inbound connections to a set of 

2 outbound connections, the computer system comprising a plurality of scheduler processes for 

3 providing TCP/IP inbound connections to agent processes for establishing corresponding outbound 

4 connections, the scheduler processes and the agent processes communicating by domain socket pairs 

5 in the computer system, each scheduler process having a dedicated domain socket pair for receiving 
6^ a TCP/IP inbound connection endpoint, the domain socket pairs for communication to the agent 
jtt processes being available from a pool of domain sockets. 

b» 1 1 . The computer system of claim 1 0 further comprising a wait queue implemented as a domain 

2^ socket pair, the wait queue receiving a TCP/IP inbound connection endpoint where no agent process 

3e is available for implementing the TCP/IP inbound connection and from which non-empty wait queue 

4i1 an available agent process will remove a TCP/IP inbound connection endpoint to establish a TCP/IP 

5f! inbound connection and an outbound connection. 

1™ 12. A computer program product for use with a computer comprising a central processing unit 

2 and random access memory, said computer program product comprising a computer usable medium 

3 having computer readable code means embodied in said medium providing a gateway between a 

4 transaction manager for managing database transactions from a set of applications, and a server, said 

5 computer program product comprising: 

6 computer readable program code means for implementing a listener process for receiving 

7 inbound connection requests from the transaction manager, 

8 computer readable program code means for implementing a set of gateway agents for 

9 establishing connections to the transaction manager for receiving transaction requests and for 
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10 establishing connections to the server, 

1 1 computer readable program code means for implementing a wait queue, 

12 computer readable program code means for implementing a logical agent scheduler for 

13 managing sets of logical agents, a logical agent comprising data representing a connected 

14 application from the transaction manager, each logical agent having an associated inbound 

1 5 connection identifier, 

1 6 whereby the logical agent scheduler passes a selected logical agent and an associated inbound 

1 7 connection identifier to an available gateway agent and where the gateway has no available gateway 

1 8 agent, providing the logical agent and the associated inbound connection identifier to the wait queue, 

19 a selected gateway agent removes a logical agent and an associated inbound connection 

20 identifier from the wait queue when the selected gateway agent is available and the wait queue is 
21^ non-empty, and 

22jf for a logical agent passed by the logical agent scheduler or removed from the wait queue, the 

23M gateway agent establishes a connection to the transaction manager as defined by the associated 

lAffz inbound connection identifier and establishes a connection to the server to implement the logical 

is? - 

25W agent. 

l Cj 13. The computer program product of claim 1 2 in which computer readable program code means 

2TI implements tightly coupled XA transactions from the set of applications by dedicating a single 

30 gateway agent to any given tightly coupled XA transaction, the listener process, the logical agent 

4 scheduler and the gateway agents passing logical agents to gateway agents such that any logical agent 

5 representing a transaction in that given tightly coupled XA transaction will be executed by a given 

6 gateway agent dedicated to that given tightly coupled XA transaction. 

1 1 4. The computer program product of claim 1 3 further comprising computer readable program 

2 code means for implementing a free agent list indicating which gateway agents are available for 

3 connection to the transaction manager and which are not dedicated to any given tightly coupled XA 

4 transaction. 



CA9- 1999-0046 



15. The computer program product of claim 12 for implementation in a UNIX-based 
environment in which the connections to the transaction manager are TCP/IP socket pairs and in 
which computer program product 

the passing of logical agents and associated inbound connection endpoint identifiers is 
implemented by the use of domain socket pairs in the gateway, 

the wait queue is implemented as a domain socket pair in the gateway, 

the logical agent scheduler has a domain socket pair dedicated for receiving logical agent and 
associated inbound connection pairs from the gateway agents and the listener process, and 

the domain socket pairs for other communication in the gateway are obtained from a pool of 
domain sockets, 

whereby in the case that no domain socket pair is available in the domain socket pool for 
transfer of a logical agent and associated inbound connection pair the logical agent scheduler will 
place the logical agent and associated inbound connection pair in the domain socket pair which 
implements the wait queue. 

16. A computer program product for use with a computer comprising a central processing unit 
and random access memory, said computer program product comprising a computer usable medium 
having computer readable code means embodied in said medium providing a gateway for 
demultiplexing connections from a first system to a second system, said computer program product 
comprising: 

computer readable program code means for implementing internal processes in the gateway 
which are selectively connected to implement the demultiplexing function of the gateway, and 

computer readable program code means for implementing a wait queue, the wait queue 
providing a buffering function for both the connections between the first system and the second 
system and for the connections between the internal processes. 
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17. The computer program product of claim 1 6 in which the connections between the first system 
and the second system are TCP/IP socket pairs and the computer readable program code means for 
implementing the connections between the internal processes implements such connections by using 
domain socket pairs. 

18. The computer program product of claim 1 7 in which computer readable program code means 
for implementing a wait queue uses a domain socket pair to implement the wait queue. 

19. A computer program product for use with a computer comprising a central processing unit 
and random access memory, said computer program product comprising a computer usable medium 
having computer readable code means embodied in said medium providing a computer system for 
demultiplexing a set of TCP/IP inbound connections to a set of outbound connections, said 
computer program product comprising: 

computer readable program code means for implementing a plurality of scheduler processes 
for providing TCP/IP inbound connections to agent processes for establishing corresponding 
Outbound connections, the scheduler processes and the agent processes communicating by domain 
socket pairs in the computer system, each scheduler process having a dedicated domain socket pair 
for receiving a TCP/IP inbound connection endpoint, the domain socket pairs for communication 
to the agent processes being available from a pool of domain sockets. 

20. The computer program product of claim 1 9 further comprising computer readable program 
code means for implementing a wait queue implemented as a domain socket pair, the wait queue 
receiving a TCP/IP inbound connection endpoint where no agent process is available for 
implementing the TCP/IP inbound connection and from which non-empty wait queue an available 
agent process will remove a TCP/IP inbound connection endpoint to establish a TCP/IP inbound 
connection and an outbound connection. 
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EFFICIENT USE OF DOMAIN SOCKET PAIRS IN COMMUNICATION 
FOR TIGHTLY COUPLED TRANSACTIONS 



ABSTRACT 



A gateway provides communication of tightly coupled XA transactions to a server hosting 
a DBMS and makes efficient use of domain socket pairs to implement demultiplexing in the 
gateway. The gateway includes a TCP/IP listener process which accepts connection requests from 
a transaction manager. Logical agents represent the application connection and are managed by a 
logical agent scheduler and are passed within the gateway using domain socket pairs. Gateway 
agents are dedicated to identified tightly coupled XA transactions to provide tightly coupled XA 
transaction support for DBMS systems which do not provide such support directly. The domain 
socket pairs in the gateway are assigned to logical agent schedulers and are available in a domain 
socket pool. A wait queue is provided to buffer logical agents when connection to the server is not 
available or where there are no domain socket pairs available in the domain socket pool. The wait 
queue is itself implemented as a domain socket pair. 
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